home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / Mac-2-dos v1.1b.adf / Amiga Utilities / HamGIF / HamGIF.notes < prev    next >
Text File  |  1978-05-20  |  7KB  |  140 lines
  1. HAMGIF (aka GIFFY version 2.5)
  2.  
  3. WARNING - This is a PRE-release version.  It is possible that it contains
  4. bugs.  The features included in this program will be included in GIFFY
  5. version 3.0, which ought to be ready sometime in the Spring of 88.  This
  6. program is being released at this time due to a number of people who
  7. requested that I support HAM displays.  This program does that, although
  8. somewhat slowly.
  9.  
  10. -------------------------------------------------------------------------
  11.  
  12. This program is a somewhat modified version of GIFFY2 which displays
  13. certain pictures in HAM mode on the Amiga.  It will automatically switch
  14. to HAM mode for any picture with more than 32 colors.
  15.  
  16. As with GIFFY2, you can specify a list of files to display, including
  17. using wildcards to specify more than one file.  It will automatically
  18. examine each file to see if it is a GIF file.  It will automatically switch
  19. resolutions to match the picture, and will enter HAM mode if the picture has
  20. over 32 colors.
  21.  
  22. It will also automatically scale any picture in HAM mode which is
  23. wider than 320 dots by 1/2 horizontally.  This allows 640 x 400
  24. or 640 x 200 pictures (very common resolutions...) to be shown on
  25. the Amiga screen in what should be close to the proper aspect ratio.
  26. It does not, in this case, remove pixels... Rather it *averages* pairs
  27. of pixels together.  So the total number of actually displayed colors
  28. could be significantly larger than the amount specified in the file.
  29. I have found that this works fairly well.
  30.  
  31. Note that for determining number of colors, I am depending on the number
  32. of colors actually in the color map.  So if the color map says there are
  33. 256 colors but only uses 16 of them (like FRBD.GIF does...), I am going into
  34. HAM mode anyway...
  35.  
  36. Usage notes - This program ought to display pictures with 32 or less
  37. colors identically to GIFFY 2.0.  The -d, -r, -c, and -s flags ought to work
  38. as usual, although the -a flag is effectively ignored in this release.
  39. (See command line parameters, below...)
  40.  
  41. Displaying HAM files is S L O W...  Part of it is due to the decoder, but
  42. most of it is due to the conversion to HAM.
  43.  
  44. Command line parameters:
  45.  
  46.    There are five optional flags:
  47.  
  48.       -d<len> - This flag changes the length of the delay between each
  49.                 GIF file displayed.  Note that this delay is the time from
  50.                 the completion of display of one GIF file to the *start* of
  51.                 display of the next GIF file.  Display time is extra.
  52.  
  53.                 The value <len> is a decimal number in seconds.  For
  54.                 example: -d5 would delay 5 seconds between files.
  55.  
  56.                 The default is a 10 second delay.
  57.  
  58.       -c        Normally when the next GIF file is displayed, the screen
  59.                 is cleared.  Most people probably will like it this way,
  60.                 but in some cases (most notably when your disk contains many
  61.                 NON interlaced pictures ["interlaced" here being the GIF
  62.                 file format, not necessarily the 400 line graphics mode...]
  63.                 all of the same resolution...) you might find it more
  64.                 esthetically pleasing to simply display right over the
  65.                 previous picture without clearing the screen.  This flag
  66.                 turns off the clearing.
  67.  
  68.                 (Note that when the screen resolution changes, or the mode
  69.                 is switched into or out of HAM, the screen is necessarily
  70.                 cleared in all cases.)
  71.  
  72.                 (HAM pictures probably don't look very good with this
  73.                 flag turned on...)
  74.  
  75.       -r        This flag tells the program to repeat the entire list of
  76.                 files continuously until the user stops the program by
  77.                 clicking on the close box.  Normally, the program will show
  78.                 the entire list of files, and holds on the last file until
  79.                 the close box is clicked.
  80.  
  81.       -s        One annoying feature of the slide show is that when you
  82.                 switch resolutions, the Workbench pops up for an instant.
  83.                 If this annoys you, you can blank it out with this flag.
  84.                 Not perfect, but better.  (It eats up some memory,
  85.                 though...)
  86.  
  87.       -e        This flag only has meaning for HAM pictures.  When
  88.                 specified, it turns on a smoothing algorithm, which tends
  89.                 to blur edges a bit, but also can result in a better looking
  90.                 picture, especially when the original was dithered before
  91.                 encoding as a GIF image.  (This type of dithering tends to
  92.                 result in badly colored horizontal line segments in sections
  93.                 of the picture.  If you see this type of thing, try using
  94.                 this flag to clear it up...)
  95.  
  96.    There may be one or more filenames, any or all of which may be standard
  97.    Amiga search patterns.  For example: "HAMGIF A#? B#?" would show all GIF
  98.    files in the current directory which begin with "A", followed by all of
  99.    the GIF files in the current directory which begin with "B".
  100.  
  101.    During display, if you click on the close box at any time, you will
  102.    exit the program.  If you click anywhere else, you will skip the current
  103.    image and begin displaying the next one.  (Useful for previewing a whole
  104.    bunch of images...)
  105.  
  106.    To get a quick summary of this information, run HAMGIF with no flags and
  107.    no filenames.
  108.  
  109. -------------------------------------------------------
  110.  
  111. Things on the wish list for GIFFY 3.0
  112. (Who knows when?  Not real soon, unfortunately...  Spring, most likely...)
  113.  
  114.    - Faster decoding/rendering, especially in HAM mode...
  115.  
  116.    - Ability to scroll screen around for pics too large
  117.  
  118.    - Smoother resolution switching
  119.  
  120.    - Wipes/Fades/Dissolves in Slide Show
  121.  
  122.    - Save image as IFF.
  123.  
  124.    - Clean up multiple images in HAM mode...  (This is gonna look *weird*
  125.      for a while folks...  You can try it, but it will come out strange...)
  126.  
  127. It seems likely that GIFFY will break into two programs:  One for slide
  128. shows, and one for working with a single image.  (The latter to get the nice
  129. things like scrolling and save as IFF...)
  130.  
  131. HAMGIF is freely redistributable.  This means you can give it to anyone you
  132. like.  It is NOT, however, intended for commercial sale.
  133.  
  134. When you give this program away, be sure to also give this file.  It
  135. contains information some user somewhere will eventually want to see.
  136.  
  137. Comments and suggestions are always welcome...
  138. -->Steve Bennett         Compuserve:[70046,441]        01/03/88
  139.  
  140.